home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 25 / AACD 25.iso / AACD / Magazine / Online / QMail / man / cat8 / qmail-inject.0 < prev    next >
Encoding:
Text File  |  1997-09-21  |  8.3 KB  |  199 lines

  1.  
  2.  
  3.  
  4. qmail-inject(8)                                   qmail-inject(8)
  5.  
  6.  
  7. NNAAMMEE
  8.        qmail-inject - preprocess and send a mail message
  9.  
  10. SSYYNNOOPPSSIISS
  11.        qqmmaaiill--iinnjjeecctt [ --nnNNaaAAhhHH ] [ --ff_s_e_n_d_e_r ] [ _r_e_c_i_p _._._.  ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        qqmmaaiill--iinnjjeecctt reads a mail message from its standard input,
  15.        adds appropriate information to the  message  header,  and
  16.        invokes  qqmmaaiill--qquueeuuee  to  send  the message to one or more
  17.        recipients.
  18.  
  19.        See qqmmaaiill--hheeaaddeerr((55)) for information  on  how  qqmmaaiill--iinnjjeecctt
  20.        rewrites header fields.
  21.  
  22.        qqmmaaiill--iinnjjeecctt  normally  exits  0.   It exits 100 if it was
  23.        invoked improperly or if there is a severe syntax error in
  24.        the message.  It exits 111 for temporary errors.
  25.  
  26. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  27.        For  the  convenience of users who do not run qqmmaaiill--iinnjjeecctt
  28.        directly, qqmmaaiill--iinnjjeecctt takes many options through environ-
  29.        ment variables.
  30.  
  31.        The  user  name  in  the  FFrroomm  header  field  is  set  by
  32.        QQMMAAIILLUUSSEERR, MMAAIILLUUSSEERR, UUSSEERR,  or  LLOOGGNNAAMMEE,  whichever  comes
  33.        first.
  34.  
  35.        The  host  name is normally set by the _d_e_f_a_u_l_t_h_o_s_t control
  36.        but can be overridden with QQMMAAIILLHHOOSSTT or MMAAIILLHHOOSSTT.
  37.  
  38.        The personal name is QQMMAAIILLNNAAMMEE, MMAAIILLNNAAMMEE, or NNAAMMEE.
  39.  
  40.        The default envelope sender address is  the  same  as  the
  41.        default FFrroomm address, but it can be overridden with QQMMAAIILL--
  42.        SSUUSSEERR and QQMMAAIILLSSHHOOSSTT.  It may also be modified  by  the  rr
  43.        and  mm  letters  described below.  Bounces will be sent to
  44.        this address.
  45.  
  46.        The QQMMAAIILLIINNJJEECCTT environment variable can  contain  any  of
  47.        the following letters:
  48.  
  49.        cc      Use address-comment style for the FFrroomm field.  Nor-
  50.               mally qqmmaaiill--iinnjjeecctt uses name-address style.
  51.  
  52.        ss      Do not look  at  any  incoming  RReettuurrnn--PPaatthh  field.
  53.               Normally,  if  RReettuurrnn--PPaatthh is supplied, it sets the
  54.               envelope sender address, overriding all environment
  55.               variables.  RReettuurrnn--PPaatthh is deleted in any case.
  56.  
  57.        ff      Delete  any incoming FFrroomm field.  Normally, if FFrroomm
  58.               is supplied, it overrides the usual FFrroomm field cre-
  59.               ated by qqmmaaiill--iinnjjeecctt.
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. qmail-inject(8)                                   qmail-inject(8)
  71.  
  72.  
  73.        ii      Delete any incoming MMeessssaaggee--IIDD field.  Normally, if
  74.               MMeessssaaggee--IIDD is supplied, it overrides the usual MMeess--
  75.               ssaaggee--IIDD field created by qqmmaaiill--iinnjjeecctt.
  76.  
  77.        rr      Use a per-recipient VERP.  qqmmaaiill--iinnjjeecctt will append
  78.               each recipient address to the  envelope  sender  of
  79.               the copy going to that recipient.
  80.  
  81.        mm      Use  a  per-message VERP.  qqmmaaiill--iinnjjeecctt will append
  82.               the current date and process  ID  to  the  envelope
  83.               sender.
  84.  
  85. OOPPTTIIOONNSS
  86.        --aa     Send  the  message  to all addresses given as _r_e_c_i_p
  87.               arguments; do not use header recipient addresses.
  88.  
  89.        --hh     Send the message to all header recipient addresses.
  90.               For   non-forwarded   messages,   this   means  the
  91.               addresses listed under TToo, CCcc, BBcccc,  AAppppaarreennttllyy--TToo.
  92.               For  forwarded  messages,  this means the addresses
  93.               listed under RReesseenntt--TToo, RReesseenntt--CCcc, RReesseenntt--BBcccc.   Do
  94.               not use any _r_e_c_i_p arguments.
  95.  
  96.        --AA     (Default.)  Send the message to all addresses given
  97.               as _r_e_c_i_p arguments.  If no _r_e_c_i_p arguments are sup-
  98.               plied,  send  the  message  to all header recipient
  99.               addresses.
  100.  
  101.        --HH     Send the message to all header recipient addresses,
  102.               and to all addresses given as _r_e_c_i_p arguments.
  103.  
  104.        --ff_s_e_n_d_e_r
  105.               Pass  _s_e_n_d_e_r  to qqmmaaiill--qquueeuuee as the envelope sender
  106.               address.  This overrides RReettuurrnn--PPaatthh and all  envi-
  107.               ronment variables.
  108.  
  109.        --NN     (Default.)   Feed  the  resulting message to qqmmaaiill--
  110.               qquueeuuee.
  111.  
  112.        --nn     Print the message rather than feeding it to  qqmmaaiill--
  113.               qquueeuuee.
  114.  
  115. CCOONNTTRROOLL FFIILLEESS
  116.        _d_e_f_a_u_l_t_d_o_m_a_i_n
  117.             Default  domain  name.   Default: _m_e, if that is sup-
  118.             plied;  otherwise  the  literal  name  ddeeffaauullttddoommaaiinn,
  119.             which  is  probably  not what you want.  qqmmaaiill--iinnjjeecctt
  120.             adds this name to any host name without dots, includ-
  121.             ing  _d_e_f_a_u_l_t_h_o_s_t  if  _d_e_f_a_u_l_t_h_o_s_t does not have dots.
  122.             (Exception: see _p_l_u_s_d_o_m_a_i_n.)
  123.  
  124.             The QQMMAAIILLDDEEFFAAUULLTTDDOOMMAAIINN environment variable overrides
  125.             _d_e_f_a_u_l_t_d_o_m_a_i_n.
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. qmail-inject(8)                                   qmail-inject(8)
  137.  
  138.  
  139.        _d_e_f_a_u_l_t_h_o_s_t
  140.             Default host name.  Default: _m_e, if that is supplied;
  141.             otherwise the  literal  name  ddeeffaauulltthhoosstt,  which  is
  142.             probably  not  what you want.  qqmmaaiill--iinnjjeecctt adds this
  143.             name to any address without a host name.  _d_e_f_a_u_l_t_h_o_s_t
  144.             need  not  be  the current host's name.  For example,
  145.             you may prefer that  outgoing  mail  show  just  your
  146.             domain name.
  147.  
  148.             The  QQMMAAIILLDDEEFFAAUULLTTHHOOSSTT  environment variable overrides
  149.             _d_e_f_a_u_l_t_h_o_s_t.
  150.  
  151.        _i_d_h_o_s_t
  152.             Host name for Message-IDs.  Default: _m_e, if  that  is
  153.             supplied; otherwise the literal name iiddhhoosstt, which is
  154.             certainly not what you want.  _i_d_h_o_s_t need not be  the
  155.             current  host's name.  For example, you may prefer to
  156.             use fake host names in Message-IDs.  However,  _i_d_h_o_s_t
  157.             must  be  a  fully-qualified name within your domain,
  158.             and each host in your domain should use  a  different
  159.             _i_d_h_o_s_t.
  160.  
  161.             The   QQMMAAIILLIIDDHHOOSSTT   environment   variable  overrides
  162.             _i_d_h_o_s_t.
  163.  
  164.        _p_l_u_s_d_o_m_a_i_n
  165.             Plus domain name.  Default: _m_e, if that is  supplied;
  166.             otherwise the literal name pplluussddoommaaiinn, which is prob-
  167.             ably not what you want.  qqmmaaiill--iinnjjeecctt adds this  name
  168.             to  any host name that ends with a plus sign, includ-
  169.             ing _d_e_f_a_u_l_t_h_o_s_t if _d_e_f_a_u_l_t_h_o_s_t ends with a plus sign.
  170.             If  a  host  name  does not have dots but ends with a
  171.             plus sign, qqmmaaiill--iinnjjeecctt uses _p_l_u_s_d_o_m_a_i_n, not _d_e_f_a_u_l_t_-
  172.             _d_o_m_a_i_n.
  173.  
  174.             The  QQMMAAIILLPPLLUUSSDDOOMMAAIINN  environment  variable overrides
  175.             _p_l_u_s_d_o_m_a_i_n.
  176.  
  177. SSEEEE AALLSSOO
  178.        addresses(5),  qmail-control(5),  qmail-header(5),  qmail-
  179.        queue(8)
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.